home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / doors_1 / murphy1a.zip / MURPHY.DOC < prev    next >
Text File  |  1991-11-17  |  13KB  |  379 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.             ---------------------------------------------------
  8.            |                                                   |
  9.            |                        The                        |
  10.            |                 MURPHY-ISMS DOOR                  |
  11.            |                    Version 1.0                    |
  12.            |          (C)Copyright 1990, Gregg Gillis          |
  13.            |                All Rights Reserved                |
  14.            |                                                   |
  15.            |                                                   |
  16.             ---------------------------------------------------
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26. DOOR DESCRIPTION:
  27. -----------------
  28. 'Murphy-isms' is a small door that displays a Murphy's Law type quote taken
  29. from a Murphy.Dat library file co-located with this program.  There are 100
  30. 'laws' supplied with the data file - to get you started.  A randomly selected
  31. Murphy-ism is produced for each caller to your board (in the 'On-Line' mode).
  32. 'Murphy-isms' has an Editor Program with which you can very easily add or
  33. delete any number of Murphy-isms to the Murphy data file.
  34. The Editor is available to those who decide to register this door.
  35.  
  36. Files in Murphy-isms (v1.0) are:
  37.  
  38.                     Murphy.dat   - Murphy-ism library of quotes
  39.                     Murphy.exe   - Main executable file
  40.                     Murphy.doc   - these docs
  41.  
  42.                     ADDMURFS.EXE - Editor system (registered users)
  43.  
  44.  
  45.  
  46. Notes:
  47. ----------------
  48. My goal:  To write superior doorware.   Files that are SMALLER and FASTER.
  49. Nothing worse than a hard drive hog of a program when you're trying to
  50. conserve disk space!
  51.  
  52.  
  53. FEATURES
  54. ----------------
  55. * Door Type *
  56.  
  57.         Written to be compatible with RBBS, QBBS, TAG, TELEGARD,
  58.         FORCE, and Remote Access, et.al. in one of several modes:
  59.  
  60.           a) This will run as a (On-Line mode) standard door from
  61.              ANY bulletin board system capable of producing the
  62.              DORINFO1.DEF information file.  That's ALL it requires.
  63.  
  64.           b) This will run from the LOGON.BAT file used by either
  65.              TAG or TELEGARD systems - providing the correct
  66.              parameters are provided (see setup).
  67.  
  68.           c) This will run as a STAND ALONE program - without any
  69.              parameters (note: usual method here is to run this at
  70.              night along with your other BBS housekeeping programs).
  71.              Important note:  Insure that the DORINFO1.DEF file is
  72.              NOT present in this mode.  This door checks for the
  73.              presence of that file (DORINFO1.DEF) - and if found,
  74.              assumes it is supposed to be outputing to the Com port.
  75.  
  76.              Running this door in a 'stand-alone' manner will
  77.              create two files:
  78.  
  79.                             1) Murphy.ANS     and
  80.                             2) Murphy.ASC
  81.  
  82.              One ANSI, the other ASCII.  These can then be displayed
  83.              to your users with the typical WELCOME screens common to
  84.              most bulletin boards.  Or, view them 'stand alone' with
  85.              the DOS TYPE command (eg: Type Murphy.Ans).
  86.  
  87. * Testing *
  88.  
  89.    This door has been tested on TELEGARD, TAG, RBBS, QBBS, and FORCE,
  90.    and Remote Access bulletin board systems.
  91.  
  92.  
  93. * Multi-Line Support *
  94.  
  95.    This has not been tested on a multi-line system.
  96.  
  97.  
  98. * Graphics *
  99.  
  100.    This door supports full ANSI as well as ASCII operation.
  101.  
  102.  
  103. * Ports *
  104.  
  105.    'Murphy' will run in LOCAL (COM 0) mode as well as through COM port 1
  106.    and COM port 2.  COM 3 and COM 4, not tested but SHOULD work!
  107.  
  108.  
  109. * Error Traps *
  110.  
  111. ->   If a user is inactive for 5 minutes, the door shuts automatically.
  112.  
  113. ->   If the carrier drops, the door slams shut and returns to the BBS.
  114.  
  115. ->   If the Murphy data file has disappeared, the door will close with
  116.      an error message (Data File Missing).
  117.  
  118. ->   If there are an incorrect number of parameters passed to the
  119.      program (when not using the DORINFO1.DEF file), the program will
  120.      print: "Incorrect number of parameters - notify SYSOP",
  121.      then exits back to the board.
  122.  
  123.  
  124. * Miscellaneous *
  125.  
  126.    This 'door' will automatically run in one of several different modes.
  127.    First, if you run it from the LOGON.BAT file (common to TAG/Telegard
  128.    BBS systems) and supply the correct number of parameters(5), it will
  129.    produce output both locally (no file creation though) and through the
  130.    COM port.
  131.  
  132.    If you choose to run it as a standard door - it will then require the
  133.    creation of a DORINFO1.DEF file (which it reads).
  134.  
  135.    Finally, it can run 'stand-alone'(which DOES create ASCII/ANSI files).
  136.  
  137.  
  138. * FOSSIL Drivers *
  139.  
  140.    This door has been tested with X00 and BNU170....  no problems were
  141.    encountered.  It has also been tested on systems NOT running a
  142.    FOSSIL driver - no troubles encountered.
  143.  
  144.  
  145. SETUP PROCEDURES:
  146. ----------------
  147.  
  148. 1. TELEGARD BBS - LOGON.BAT style:
  149.  
  150.       In your LOGON.BAT file, you will need to have this information
  151.       written, exactly as it is written here, in order for the
  152.       Murphy-ism program to greet your users as they log on.
  153.  
  154.  
  155.                          MURPHY %1 %3 %4 %5 %6
  156.  
  157.       The Murphy.EXE and Murphy.DAT files must be in the same directory
  158.       as your logon.bat file (unless you specify directory changes in
  159.       your LOGON.BAT file).  And that's all there is to it.
  160.  
  161.  
  162. 2.  TAG BBS - LOGON.BAT style:
  163.  
  164.       In your LOGON.BAT file, you'll need this line, exactly as it is
  165.       written here:
  166.  
  167.                          MURPHY %6 %1 %8 %4 %2
  168.  
  169.       As with the Telegard system, the files: Murphy.EXE and Murphy.DAT
  170.       must be in the same directory as your LOGON.BAT file (unless,
  171.       again, you specify directory changes in your LOGON.BAT file).
  172.  
  173.  
  174. 3.  TELEGARD, TAG, RBBS, QBBS, FORCE!, Remote Access, and any other BBS
  175.     that can make a DORINFO1.DEF file:
  176.  
  177.       This door requires NO configuration files, no BRUNS, no DORPCH's.
  178.       As a result, you get a nice door that takes up but a little disk
  179.       space.
  180.  
  181.       Follow the directions in the docs that came with your bulletin
  182.       board system to set up this door - paying attention to examples
  183.       in the docs pertaining to DORINFOx.DEF doors.
  184.  
  185.  
  186. 4.  Stand-Alone (or Local) style:  (Simulating what users see remotely)
  187.  
  188.       Enter this in your command line:
  189.  
  190.               MURPHY  'any string'  0 1 1 0
  191.  
  192.       Like so:    MURPHY Joe 0 1 1 0     (for ANSI)
  193.  
  194.                   MURPHY Schmoe 0 0 0 0  (for ASCII)
  195.  
  196.       That'll do it.
  197.  
  198.  
  199. 5.  Stand Alone - Producing ANSI and ASCII files for display:
  200.  
  201.     Easy.....  just run
  202.  
  203.                   MURPHY    (no parameters)
  204.  
  205.     That's it!  Nothing to it!
  206.  
  207.  
  208.  
  209. ACKNOWLEDGEMENTS:
  210. ----------------
  211. I used Turbo Pascal 5.5 (Borland) for this door - a very superb language.
  212. Thanks also to John Parlin who has assembled an excellent Turbo Pascal
  213. Unit called: JPDOOR (look for it on your favorite BBS).
  214.  
  215.  
  216. REGISTRATION  (Oh Yuck... you just knew this dirty word was in here)
  217. ----------------
  218.  
  219. The registration donation is (U.S.) $7.00 (check or money order only).
  220.  
  221.           So, you ask....  "Why should I register this thing?"
  222.  
  223. Because:  if you do register, you will be supporting Shareware
  224. principles, and will be encouraging me to finish writing my other Doors,
  225. as well as several new TPU units for Turbo Pascal 5.5.  And, you'll
  226. be offsetting the time and resources it takes to put these things together.
  227. Additionally, I'll send you a BIG 'Thank You!!!' note.
  228.  
  229. But wait, there's MORE!  
  230.  
  231. You will receive a registered version of this door.
  232. That means... I'll send you a 5.25" disk with a version of MURPHY-ISMs
  233. that will display that it is registered to YOU.  In addition, I'll send
  234. you (with MURPHY-ISMs) the latest EDITOR program for this doorway.
  235.  
  236. All versions that DO NOT display a REGISTRATION name and when run
  237. from a BBS, are considered UNREGISTERED.  Please support Shareware authors
  238. and register this software.
  239.  
  240.  
  241.  
  242. WARRANTY   (PLEASE READ - because there isn't any!)
  243. ----------------
  244. This product is provided on an 'as is' basis without warranty of any kind.
  245. It is advisable to SCAN (using the latest Virus Scanner) the files on this
  246. and any disk if you have not received them directly from me through the mail.
  247. You assume all risks as to the results and performance of this program.
  248. I, as author, can accept no responsibility for system damage, loss of profit,
  249. or any other accidental, consequential, special, legal, illegal, or unseen,
  250. thought of or unthought of, or anything damage resulting from the use or
  251. disuse of this product.
  252.  
  253.  
  254. SHAREWARE
  255. ----------------
  256. 'MURPHY-ISM' is distributed as Shareware. What this means is:  you may use
  257. the Unregistered version for a period of:
  258.  
  259.                           thirty days (30).
  260.  
  261. During this time, you will be evaluating this software.  Should you decide this is worthwhile,
  262. you will register your copy of this program or discontinue using it.
  263.  
  264.            
  265. DISTRIBUTION
  266. ----------------
  267. MURPHY-ISM v1.0:
  268. You are encouraged to share this program with other SYSOPS and
  269. users, so that they too may evaluate the usefulness of this program.
  270. There's only one hitch!  You may not alter the contents, add to, or
  271. remove any files associated with this archive - meaning that if you
  272. distribute this, it must be distributed in it's original, un-modified
  273. state.  You are also prohibited from charging anything for the distribution
  274. of this software (free distribution).
  275.  
  276.            
  277. BUGS, SUGGESTIONS, COMMENTS:
  278. ----------------------------
  279. I am open to all suggestions, comments, and feedback.  If you spot a bug
  280. or find a rough spot, please let me know.  Thanks very much!
  281.  
  282.  
  283.                          Gregg Gillis
  284.  
  285.                          Address: Until May '91:
  286.  
  287.                              120 Northland
  288.                              Marquette, MI  49855
  289.  
  290.                          Address: After May '91:
  291.  
  292.                              4125 Stratford
  293.                              Boardman, OH 44512
  294.  
  295.  
  296.  
  297.  
  298. OTHER SOFTWARE DOORS by Gregg Gillis
  299. ---------------------------------------------------------------------------
  300.  
  301.           'Quote-Of-The-Day' Door  :  Uses a standard file of quotes or
  302.                                       you may add/delete quotes with the
  303.                                       Quote Editor.  Small and Fast.
  304.  
  305.           'The WALL'               :  Grafitti Door
  306.  
  307.           'The Town Cryer'         :  Notices and Announcements Door.
  308.                                       Ideal for Special Interest groups
  309.                                       or organizations.
  310.  
  311.           'The Really Excellent
  312.            BBS Database Door'      :  BBS Database door - features B+ Tree
  313.                                       structures. Searches accept wildcards,
  314.                                       and even has several configurable
  315.                                       fields, including *Net address field.
  316.                                       ASCII & ANSI output.
  317.  
  318. ---------------------------------------------------------------------------
  319.  
  320.  
  321. REGISTRATION FORM:
  322.  
  323.                          Address: Until May '91:
  324.  
  325.                              120 Northland
  326.                              Marquette, MI  49855
  327.  
  328.                          Address: After May '91:
  329.  
  330.                              4125 Stratford
  331.                              Boardman, OH 44512
  332.  
  333.  
  334.  
  335. -----------------------------------------------------------------------------
  336.  
  337. The registration fee for 'MURPHY-ISM', Version 1.0,  is $7.00 , U.S.
  338. (check or money order only).
  339.  
  340.  
  341.  
  342.                                REGISTRATION FORM
  343.                                -----------------
  344.  
  345.  
  346.           Your Name:  _________________________________________________
  347.  
  348.  
  349.           Street: _____________________________________________________
  350.  
  351.  
  352.           City: _____________________________State:__________Zip:______
  353.  
  354.  
  355.  
  356.           Name or BBS name you want this registered to:
  357.  
  358.  
  359.                                          ______________________________
  360.  
  361.  
  362.           Other questions:      BBS Type  _____________________________
  363.  
  364.                                 Type computer _________________________
  365.  
  366.                                 Max baud rate _________________________
  367.  
  368.                                 Use a FOSSIL driver? (Y/N)  _____
  369.  
  370.                                 If yes, what version: _________________
  371.  
  372.  
  373.  
  374.           Make donation payable to:   'Gregg Gillis'
  375.  
  376.  
  377. -----------------------------------------------------------------------------
  378. Comments:
  379.